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ABSTRACT 



The present invention is related to "trace" and debugging 
capability in the operation of the Java programming utility. 
It represents a means to execute a program in such a way that 
the sequence of statements being executed can be observed. 
It is related to "debugger", which is a program designed to 
aid in debugging another program by allowing the program- 
mer to step through the program, examine the data and 
monitor conditions, such as the values of the variables, and 
correct the problem. 

24 Claims, 2 Drawing Sheets 
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METHOD AND APPARATUS FOR Java, well established in the late 1990s, is an object 

MONITORING THE EXECUTION OF A oriented programming language developed by Sun 

PROGRAM Microsystems, Inc. While Java is similar to C++, Java is 

smaller, more portable and easier to use than C++. This is 

5 because it is more robust and it manages memory on its own. 

TECHNICAL FIELX) Java was designed to be secure and platform neutral. In 

A portion of the disclosure of this patent document other words, it can be run on any platform since Java 

contains material which is subject to copyright protection. programs are complied into byte codes, which are similar to 

The copyright owner has no objection to the facsimile machmc code and are not specific to any platform, 

reproduction by anyone in the patent disclosure, as it appears The term "trace" can be defined as a means to execute a 

in the Patent and Trademark OfBcc patent files or records, program in such a way that the sequence of statements being 

but otherwise reserves all copyright rights whatsoever. executed can be observed. This is related to "debugger**, 

which is a program designed to aid in debugging another 

BACKGROUND OF RELATED ART program by allowing the programmer to step through the 

1 c- u <r ♦u n * T 4-- program, examine the data and monitor conditions such as 

1. Field of the Present Invention fu i c .u • ui 

the values of the variables. 

The present invention is related to "trace" and debugging ^n. . ^ u * j * . i * j 

. . r 4U T * T* Th^ t^rin debug means to detect, locate and correct 

capability m the operation of the Java utihty program. It , , , . i • t^L • 

™™c*.„t. o n «™..o™ •„ <.,.^u o Z.,, iU-.i logical or syntactical errors in a program or malfunctions in 

represents a means to execute a program m such a way that . t u j. . ..l . . li l < 

, , * u • * J u u J on hardware. In a hardware context, the term troubleshool IS the 

the sequence of statements bemg executed can be observed. 20 ^ _ , • n . .i • 

It is related to "debugger", which is a program designed to """'^ "f**" ^^^^'^'y ^l^'" ^ P'°''l*™ * ""^J"' 

aid in debugging another program by allowing the program- 
mer to step through the program, examine the data and SUMMARY OF THE PRESENT INVENTION 
monitor conditions, such as the values of the variables, and 

identify problem errors. 25 The preferred embodiment of the present invention is an 

2. History of Related Art Execution Trace Facility that is written in 100% Java and 
It is helpful to describe the software test process to provid«» execTition tracing capability. TTiis capability m^^^ 

demonstrate the utility of the current invention. A available the Java Package name Class name. Method name 

("Generic" process for software testmg would be as follows. ^'f" ^ V ' °/ 'fj' "".f I f'' 

After software is designed and written, it is unit tested, ^ ^^^^ ^^ich the trace facility was called. In other 

functionally tested, system tested and then released as a " makes avadable all pertinent data required to trace 

product. During the various test phases, testers execute the P'°^'"^ execuUon flow. This facility is usefiil for program 

programasanormalusermightdo.Iferrorsareencountered P'°^^''" identification and resolution. It provides detailed 

the program can be executed in a controlled "debug" envi- P'^"^^ execution trace information that, when analyzed, 

ronment. Debug environments are external to and distinct ''^^^'^^ °^ P'°g"°' ^^^^I " '^.^'f^^l 

from the program being tested. Although quite useful, they incorpofated into leleasable product code in a disabled 

are complicated and require a level of experience and skiU "^"^ « "° ^"'l "^^ "wareiiess of it s 

to operate effectively. Within debug environments, the pro- P^^f °f • ^ P'^f*"* ""^ facility can be 

gram under test can be suspended at definable points and it's ^"^^^^^ and valuable trace mformation generated. One sig- 

. f ■ ^ ^ i A^*^^^ ,.^ -e If «^ A^.: ^a nificant attribute of the present invention is that no addi- 

state inspected to determine it it is executmg as designed. . , , , ■ . 

For example, if a program is to create temporary files at '^"""l debugging environment above and beyond the pro- 
some point during it's execution, the program can be sus- ^'"^ "^^^ "^"^^'^^ ^ e^"*^'"^ "'^ P^^S'*-" ^x^cntion 
pcnded at an appropriate point and the tester can determine trace. 

if the temporary files exist and are in the correct format. A call to the Execution Trace Facility is inserted into the 
After a software product is released for sale, there are °^ progf^m to be tested at various strategic 
invariably still some, to a lesser or greater degree, defects ^o^M mually as the first fine of each method and the 
present in the product. Consumer support personnel. program is recompiled. TTie program is then used id a normal 
employed by the software development companies, are operating environment. If durmg normal execution a pro- 
responsible for deteraiining the cause of program malfunc- „ S"-^ Execution Trace Facihty can 
tions based on customer input after the product is in the '° be enabled and the program restarted Execution trace mfor- 
hands of the customer. At customer sites, when program """^""^ generated, which faahtates error detection, 
defects arise, there is almost never the skUl or a debug g^j^p DESCRIPTION OF TOE DRAWINGS 
environment available to help diagnose malfunctions. Cus- 
tomer support personnel must attempt to diagnose malfunc- The present invention will be better understood and its 
tions with a minimum of diagnostic information. This is a numerous objects and advantages will become more appar- 
very serious problem facing software development firms in ent to those skilled in the art by reference to the following 
today's computer marketplace. drawings, in conjunction with the accompanying 

It would therefore be a distinct advantage to have a specification, in which: 

method and system that would overcome the many problems PIG. 1 is a flowchart depicting the steps employed using 

enumerated above. The present invention provides such a the Execution Trace FacUity. This is the basis of the present 

method and apparatus. invention. It shows how this system is employed to detect 

program malfunctions; and 

FIG. 2 represents the second half of the process corn- 
Before going into the details of the present mvention, it 65 mencing just after the query as to whether during the 
might be appropriate to define certain terms which are used execution a malfunction occurs in FIG. 1 and ends with error 
in the description of the system. detection and correction. 
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DETAILED DESCRIPTION OF THE 
PREFERRED EMBODIMENT 

There are numerous advantages and benefits to the present 
invention Execution Trace Facility. This invention is distin- 
guished from currently existing "trace implementations" in 
that most implementations require that each call to the trace 
facility be "hardcoded" within the calling routiners execu- 
tion context, i.e. the currently executing filename, 
subroutine, etc., in order to enable the debugger to locate the 
currently executing code segment. Hiis necessitates a great 
deal of programmer effort in the initial coding and ongoing 
maintenance. The Execution Trace Facility needs merely to 
be called and it generates the trace information automati- 
cally locating the currently executing code segment. 

Another benefit is that this invention does not require any 
additional debug environment. It is an integral part of the 
application itself. Other trace facihties require an additional 
debug program which monitors and controls the execution 
of the program under test. 

The Execution Trace Facifity, as noted above, is a method 
for tracing computer software program flow through it's 
various component modules, thereby providing valuable 
information for diagnosis and repair of software defects, 
without the use of an external debug environment. The 
Execution Trace Facility is very easily incorporated by 
software developers into the software product itself by 
merely inserting calls to the facility's trace function. During 
development, as a software product evolves, its underlying 
code may change many times. Through this product 
evolution, the Execution Trace FaciUty requires almost no 
maintenance to be kept fully functional. 

In it's use this facility is bimodal. It is either enabled or 
disabled. It is shipped to the customer in product code in a 
disabled mode in which its presence is invisible to the 
customer. The software program functions normally as if the 
trace facility was not there. Should a program malfunction 
occur, the Execution Trace Facility can be enabled and it will 
provide valuable diagnostic information. 

The process for enabling and disabling this facility makes 
use of the way in which Java programs are executed by the 
Java Virtual Machine (JVM). The JVM uses a ("classpath" 
environment variable to locate class files that are called by 
the currently executing Java program. (The classpath is 
similar in form and function to the ("path" environment 
variable that is used by many operating systems to locate 
executable files.) As the JVM searches the classpath, the first 
file that matches the name of the routine for which it is 
searching is brought into the JVM and used by the executing 
Java program. If duplicate file names exist in the classpath 
directories, the files located farther down in the classpath 
search are never found or used by the JVM. 

J ayP; ver sions of thc'ExecuUon^ FaciUty are shipped 
;Wi\h each proHuct'i 01ie version, the enabled version, js^fully 
fiinctional. It generates the trace information. -The other 
version, the disabled version, is a "stub" program. A~^Stub 
program has no functional code inside its methods. It 
contains identical method declarations to, and is an accept- 
able substitute for, an enabled version. It's methods do not 
perform any function when they are called. 

A program product that contains the Execution Trace 
Facility is shipped with the trace facility in a disabled mode. 
In this mode, the disabled version of the trace facility is 
located where it can be found by the JVM as it searches the 
classpath. The enabled version of the Execution Trace 
Facility is in a directory that does not appear in the classpatb 
and is, therefore, never found by the JVM, 
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The trace facihty is enabled by a simple program which 
prepends the classpath with the name of the directory 
containing the enabled version of the Execution Trace 
Facility. The enabled version is now located first in the 
classpath and is used by the JVM. The trace facility is 
disabled by restoring the classpath to its original state . The 
Execution Trace Facility requires no additional skill or 
customer interaction to operate. 

The Source Code for accessing the present invention. 
Execution Trace Facility, is set forth as follows in Java 
language. 

package Util; 

public class Trace Test 

{ 

public static void main(String args[ ]) 

{ 

Tracer.trace( ); 
new Trace Test( ); 

} 

public TraceTest( ) 
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{ 

Tracer.trace( ); 
funcl( ); 
func2( ); 
return; 

} 

private void funcl( ) 

{ 

Tracer.trace( ); 
return; 

} 

private void func2( ) 

{ 

Tracer.trace( ); 
return; 

} 

} 

+ Class Trace Test 

^^♦4 + ********** ♦♦*** + **+g£QJJ^ Output 

//* ♦ * output is of the form: Executing: 
Package. CI ass. Method: lineNumber* * * * * 
Executing:Util.TraceTest.main:7 
Executing:Util.TraceTest.<init>:13 
Executing: U til .TraceTest .fund :21 
Executing: Util .TraceTest,2:27 

ll^^m^^^f^^^m***************. £fvf[) Output 

^^♦♦♦♦♦H.+******************B£(3ij^ Source code for 

Trace 
Facihty 

******* 

package Util; 
import java.io*; 

import java.util.StringTokenizer; 
import javalang.String; 
public class Tracer 

^ . . . 

public static void trace( ) 
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{ 

java.lang.Syslem.out.prmlln("Executing:"+ 
Tracer.getMethod(2)); 

} 

private static String getMethod(int callDepth) 

{ 

if (!(System.getProperties( ).getProperty 
("os.aame").equals("OS/2"))) 

{ 

calLDepth++ 

} 

Error e=>Dew Enror( ); 

StringWriter stringwriter-new Stringwriter( ); 
PrintWriter printwriter=new 

PrintWriter(stringwriter); 
e.priDtStackTrace(printWriter); 
StringTokenizer sT=new 

StringTokenizer(stringWriter.toString( )/'\n"); 
String method; 
for (int i=0; 

i<callDepth+l; 

i++) 

{ 

method-sT.QextToken( ); 

} 

method-sT.aextToken( ).trim( )^ubstring(3); 
if(method.indexOf("Complied Code")>-l) 
{ 

method=method,substring(0, method. indexOf 
("Compiled Code"))+")"; 

if(!(System.getProperties( ).getProperty("os.name") 
.equalsC*0S/2))) 



{ 



} 



method=method.substring(0, method. indexof(" 
C'))+m6thod.substring(method.indexof(":"), 
(raethod.length( )-l)); 
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return method; 

} 

} 

* :^ ^ ******* 4c* 

Facility 
****************** 
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Copyright 1998 International Business Machines Corpo- 
ration. 

FIG. 1 is a flowchart that depicts the process of employing 
the Execution Trace Facility. The process begins at 100. The 
process calls for the Execution Trace Facihty to be inserted 
into the code of the program at 102. The Execution Trace 
Facility is inserted at various locations which are strategic to 
facilitate trace, usually as the first line of each method 102. 
The program is then recompiled 103 and then used in a 
normal operating environment. 

The query is then raised at 105 as to whether a malfunc- 
tion occurs. If there is no malfunction then the program is 
executed to completion at FIG. 2 at 109. However, if the 
answer to FIG. 1 at 105 is yes then the Execution Trace 
Facility is enabled and the program is restarted at FIG. 2 
106. Then the Execution Trace Facility information is gen- 
erated which facihtates error detection and correction at 107 
and then the program is executed at FIG. 2 108 and the 
program is successfully completed at FIG. 2 109. 

While the invention has been shown and described with 
reference to particular embodiments thereof, it will be 
understood by those skilled in the art that the foregoing and 
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other changes in form and detail may be made therein 
without departing from the spirit and scope of the invention. 
What is claimed is: 

1. An Execution Trace Facility computer system, which 
provides all avaOablc pertinent data required to trace a 
program flow for malfunctions, comprising: 

means for inserting said Execution Trace Facility into the 

code of the program in a disabled mode, at various 

strategic locations; 
means for recompiling said program after said Execution 

Trace Facility is inserted into said code of the said 

program; 

means for using said program in a normal operating 
environment and for determining if a malfunction of 
said program occurs; and 

means for enabling said Execution Trace Facility to restart 
said program and detect and correct said malfunction 
only in response to a detection that a malfunction of 
said program has occurred. 

2. The computer system of claim 1 wherein said Execu- 
tion Trace Facflity upon activation, generates the trace 
information automatically. 

3. The computer system of claim 2 wherein the activation 
of said Execution Trace Facility, locates the currently 
executing code segment. 

4. The system of claim 1 wherein said system is based on 
the JAVA object oriented programming language. 

5. The system of claim 1 wherein said Execution Trace 
Facility is a Java utility, which provides said execution 
tracing capability; and 

which makes available a Java Package name, Class name, 
Method name and source code line number of the hue 
code in said Java class from which said Execution 
Trace Facihty was called. 

6. The system of claim 1 which makes available all 
pertinent data required to trace program execution flow and 
program problem identification and resolution. 

7. The system of claim 1 which does not require any 
additional debug environment to monitor and control the 
execution of the program under test. 

8. The system of claim 1 wherein said Execution Trace 
Facility can be readily incorporated, by software developers, 
into the software product by merely inserting calls to the 
facility's trace function. 

9. An Execution Trace Facility computer method, which 
provides all available pertinent data required to trace a 
program flow for malfunctions, comprising: 

inserting said Execution Trace Facility into the code of the 
program in a disabled mode, at various strategic loca- 
tions; 

recompiling said program after said Execution Trace 
Facility is inserted into said code of the said program; 

using said program in normal operating environment and 
determining if a malfunction of said program occurs; 
and 

enabling said Execution Trace Facility to restart said 
program and detect and correct said malfunction only 
in response to a determining that,a malfunction of said 
program has occurred. 

10. The computer method of claim 9 wherein said Execu- 
tion Trace FaciUty upon activation, generates the trace 
information automatically. 

11. The computer method of claim 10 wherein the acti- 
vation of said Execution Trace Facility, locates the currently 
executing code segment. 

12. The computer method of claim 9 wherein said system 
is based on the JAVA object oriented programming lan- 
guage. 
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13. The computer method of claim 9 wherein said Execu- 
tion Trace Facility is a Java utility, which provides said 
execution tracing capability; and 

which makes available the said Java Package name, Class 
name, Method name and source code line number of 
the line code in said Java class from which said trace 
facility was called. 

14. The computer method of claim 9 which makes avail- 
able all pertinent data required to trace program execution 
flow and program problem identification and resolution. 

15. The computer method of claim 9 which does not 
require any additional debug environment to monitor and 
control the execution of program under test. 

16. The method of claim 9 wherein said Execution Trace 
Facility can be readily incoq)orated, by software developers, 
into the software product by merely inserting calls to the 
facility's trace function. 

17. A computer readable program having data structures 
included on a computer readable medium which causes the 
display on a data processor controlled display of an Execu- 
tion Trace Facility computer program, which provides all 
available pertinent data required to trace a program flow for 
malfunctions, comprising: 

means for inserting said execution Trace Facility into the 

code of the program in a disabled mode, at various 

strategic locations; 
means for recompiling said program after said Execution 

Trace Facility is inserted into said code of the said 

program; 

means for using said program in normal operating envi- 
ronment and for determining if a malfunction of said 
program occurs; and 
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enabling said Execution Trace Facility to restart said 
program and detect and correct said malfunction only 
in response to a determining that a malfunction of said 
program has occurred. 
5 18. The computer readable program of claim 17 wherein 
said Execution Trace Facihty upon activation, generates the 
trace information automatically. 

19. The computer readable program of claim 17 wherein 
the activation of said Execution Trace Faclity, locates the 

jQ currently executing code segment. 

20. The computer readable program of claim 18 wherein 
said system is based on the JAVA object oriented program- 
ming language. 

21. The computer readable program of claim 17 wherein 
J 5 said Execution Trace Facility is a Java utility, which pro- 
vides said execution tracing capability; and 

which makes available the said Java Package name. Class 
name. Method name and source code line number of 
the line code in said Java class from which said trace 
20 facility was called. 

22. The computer readable program of claim 17 which 
makes available all pertinent data required to trace program 
execution flow and program problem identification and 
resolution. 

25 23. The computer readable program of claim 17 which 
does not require any additional debug environment monitor 
and control the execution of program under test. 

24- The computer readable program of claim 17 wherein 
said Execution Trace Facility can be incorporated, by soft- 

30 ware developers, into the software product by merely insert- 
ing calls to the facility's trace function. 

♦ ♦ * ♦ ♦ 
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